home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 101-125 / scopedisk125 / setmouse / sm.doc < prev    next >
Text File  |  1995-03-19  |  5KB  |  132 lines
  1.  
  2. >   What is "sm"...
  3.  
  4.     "sm" (previously referred to as "SetMouse") is an AmigaDOS executable
  5.     which sends Intuition a message that mouse EVENTS can be found at either
  6.     one of the Amiga's two mouse/game ports.
  7.  
  8.     Based upon source code written by R. "Kodiak" Burns many moons ago,
  9.     (the date of his source is 08-Apr-86), "sm" is slightly larger in
  10.     program size, but now contains more features.  I have also re-written
  11.     the source to reflect compiler upgrades and to make it easier to
  12.     maintain (as per my own specific programming guides).
  13.  
  14. >   Distribution and Warranties...
  15.  
  16.     The program, "sm", as well as this documentation are freely
  17.     distributable, and may be used as you wish.  No warranties of any kind,
  18.     either specific or implied are carried with this product.  The only
  19.     guarantee made is that the executable and the documentaion will occupy
  20.     space on a disk.
  21.  
  22. >   Requests and Bug Reports...
  23.  
  24.     Charles Conlow, of Artemis Software is the person to contact if you have
  25.     any questions regarding this, or future revisons of "sm".  I can be
  26.     reached electronically:
  27.  
  28.     Compuserve      74116,3067
  29.     InterNet        74116,3067@compuserve.com
  30.     GEnie           C.CONLOW
  31.  
  32.     ...Alternately:
  33.  
  34.     USMail          Charles Conlow/Artemis Software
  35.                     2144 California Street NW
  36.                     Suite 808
  37.                     Washington, DC  20008
  38.  
  39. >   Why "sm"...
  40.  
  41.     Some time ago, my Amiga started acting really flakey.  Intuition would
  42.     put up requesters that the printer was not connected, when it was.  The
  43.     mouse pointer would travel in only horizontal directions, no matter how
  44.     the actual mouse was moved.
  45.  
  46.     Of course, computers only break when the deadline for a major project is
  47.     very close.  I could not take the beastie in to the shop right away, so
  48.     a quick work-around was in order.
  49.  
  50.     The printer problem was solved by sending output to a disk file, then
  51.     using another Amiga to get hardcopy.  The mouse problem was slightly
  52.     more difficult.  I had the source for Bob Burns "setmouse" handy, and
  53.     just as a test, compiled it right off.  Using "setmouse", and plugging
  54.     the mouse into the right port, all was well!  Computer later saw repair
  55.     at shop, and 8520s were replaced, effecting repair.
  56.  
  57.     "SetMouse" was then relegated to archive disk, and forgotten.  Recently
  58.     a CIS user asked for a program to switch active mouse ports.  What do
  59.     you know?  "sm" is a further enhancement to that program.
  60.  
  61. >   Program usage...
  62.  
  63.     At a command line prompt, type the program name ("sm"), and the port
  64.     that you wish Intuition to look at for mouse EVENTS.  For example, if
  65.     you wish to plug the mouse into the right-most port, and tell Intuition
  66.     about the change you have made, type...
  67.  
  68.     sm 1
  69.  
  70.     ...all mouse EVENTS will be handled correctly.  To re-establish the
  71.     default condition, plug the mouse into the left-most port and type...
  72.  
  73.     sm 0
  74.  
  75.     ...and you are back to normal.  Some programs, and these are few and
  76.     far between, may look directly to the Amiga hardware for mouse EVENTS.
  77.     The default mouse port is #0, the left-most port.  If you have plugged
  78.     the mouse into port #1, and used "sm" to tell Intuition about it, any
  79.     programs which are looking at the hardware of port #0 will never see
  80.     any mouse EVENTS.  You should immediately contact the authors of those
  81.     programs and scold them severly.  They have written their programs in a
  82.     very un-Amiga-like way.
  83.  
  84.     Typing "sm" with no (or invalid) arguments will display a simple usage
  85.     template.
  86.  
  87. >   Electrical considerations...
  88.  
  89.     Having mentioned several times "plugging the mouse" and "unplugging the
  90.     mouse", I think it is necessary to point out that...
  91.  
  92.     YOU SHOULD NEVER, *** EVER *** PLUG OR UN-PLUG THE MOUSE WHEN THE
  93.                           COMPUTER IS TURNED ON!!!
  94.  
  95.     This is true of any and all expansion cards, external control devices,
  96.     printers, modems and whatever do_dads are connected to your computer.
  97.     There are electrical signals on all these ports, and the damage that a
  98.     single static discharge can cause is considerable.  So please make sure
  99.     the computer is turned *** OFF *** whenever you are connecting or
  100.     disconnecting *** ANYTHING *** to it.
  101.  
  102.     If you wish to use "sm" to switch mouse ports, follow these steps...
  103.  
  104.     1. In your startup-sequence, add the following line
  105.  
  106.        sm PORT
  107.  
  108.        ...where PORT is the port that you will be using (0 or 1).
  109.  
  110.     2. If computer is on, turn it off.
  111.  
  112.     3. Unplug the mouse from its current location.
  113.  
  114.     4. Plug the mouse into the desired location (the PORT mentioned above).
  115.  
  116.     5. Turn the computer back on, and boot as usual.
  117.  
  118.     A message will appear on the screen during the execution of the
  119.     startup-sequence, and when the computer has finished booting, the mouse
  120.     EVENTS will be broadcast from the port you requested.
  121.  
  122. >   Programmer's note...
  123.  
  124.     Unless requested, no further enhancements will be made to this program.
  125.     Several come to mind, and they would be simple to implement.  But they
  126.     are for other programs.  "sm" serves the purpose for which it was
  127.     created.
  128.  
  129.     Additionally, I really don't want to make this document any longer than
  130.     it already is ;-)
  131.  
  132.